feat: expose design data as AI agent plugin skills - #1

Summary

이 저장소의 디자인 데이터셋(assets/data/*.json)을 AI 코딩 에이전트가 직접 질의할 수 있도록 멀티호스트 플러그인 매니페스트와 스킬 2종을 추가합니다.

사이트를 렌더링하는 것과 동일한 JSON을 그대로 읽습니다. 데이터를 복제하지 않으므로 기존 데이터를 고치면 사이트와 스킬에 동시에 반영됩니다.

지원 호스트: Claude Code · Codex · agy

Motivation

49개 ism과 94개 UI 효과는 이미 팔레트 헥스값, 폰트 페어링, 그리드 수치, 실행 가능한 HTML/CSS/JS 스니펫까지 구조화되어 있습니다. 지금은 사람이 브라우저에서 보는 용도로만 쓰이는데, 같은 데이터를 에이전트가 읽으면 "미니멀리즘 팔레트로 만들어줘" 같은 요청에 이 저장소의 값이 그대로 쓰입니다.

What's included

변경 없음: 기존 HTML/CSS/TS/데이터 파일은 한 줄도 건드리지 않았습니다. 전부 신규 파일 추가입니다 (11 files, +439, -0).

How it works

skills/style/SKILL.md      ← 진실 원천
skills/effect/SKILL.md     ← 진실 원천
.claude/skills/style  -> ../../skills/style    (심링크)
.claude/skills/effect -> ../../skills/effect   (심링크)

호스트 발견용 디렉토리는 복사본이 아니라 심링크입니다. SKILL 문서가 중복되지 않고, fresh clone 후에도 정상 해석되는 것을 확인했습니다.

스킬은 assets/data/의 JSON을 읽기만 하며 쓰지 않습니다.

Example

미니멀리즘 컬러 팔레트 추천해 →

#FFFFFF  배경
#1A1A1A  본문 텍스트
#F5F5F5  보조 배경
#E0E0E0  구분선

폰트: sans-serif (Inter + system-ui)
그리드: 단순 그리드 시스템 (1-2 컬럼 중심), gutter 24px

값 전부 isms.json / dev-guides.json에서 온 것입니다.

Verification

• npm run verify — 전체 통과 (typecheck, nav, isms, effects, snippets, finder, content, catalog, assets, image-quality, lines)
• npm run pages:stage — 0 forbidden, 배포 트리에 플러그인 파일 유입 없음
• 리모트 설치 실측 — marketplace add → install → Skills (2) effect, style 확인

Impact on the site

없습니다.

• 배포 트리(.pages/)에 플러그인 파일이 포함되지 않음 — stage-pages.mjs가 허용 목록 기반이라 자동 제외
• deploy.yml은 assets/·*.html만 배포
• 정적 사이트 빌드(src/, scripts/)와 무관

Checklist

• npm run verify 통과 (typecheck · nav · isms · effects · snippets · finder · content · catalog · assets · image-quality · lines)
• npm run pages:stage 통과 — 0 forbidden, 배포 트리에 플러그인 파일 유입 없음
• 기존 HTML/CSS/TS/데이터 파일 무변경 (11 files, +439, -0)
• 스킬은 assets/data/ JSON을 읽기만 함 (쓰기 없음)
• 3개 호스트 매니페스트 유효 — forge doctor FAIL 0
• 리모트 설치 실측 — marketplace add → install → Skills (2) effect, style
• fresh clone 후 심링크 정상 해석 확인
• AGENTS.md 디렉토리 구조 절 갱신 — PR 수용 시 진행

결정이 필요한 사항

• 마켓플레이스 이름 — design-isms@lidge-jun으로 설치됩니다. 다른 이름을 원하시면 marketplace.json의 최상위 name을 바꾸면 됩니다.
• 저장소 성격 — 정적 사이트 저장소가 플러그인 배포처를 겸하는 구조를 수용하실지. 원치 않으시면 별도 저장소로 분리하는 편이 낫습니다.

동작 확인

• CI(Static integrity) — fork PR이라 메인테이너 승인 후 실행됩니다. 로컬에서 npm run verify + npm run pages:stage 모두 통과 확인했습니다
• 머지 후 main에서 claude plugin marketplace add lidge-jun/design-isms 동작 — 매니페스트가 기본 브랜치에 있어야 하므로 머지 전에는 검증 불가
• GitHub Pages 배포에 영향 없음 — pages:stage 결과 0 forbidden이나, 실제 배포 후 라이브 사이트 확인 권장

알아두실 사항

• .claude/skills/는 심링크(git mode 120000)입니다. Windows에서 core.symlinks=false로 클론하면 링크가 텍스트 파일로 체크아웃되어 깨집니다. 사이트 동작에는 무관하며, 문제가 되면 해당 디렉토리는 삭제해도 플러그인이 정상 동작합니다(실측 확인).

Notes

• 매니페스트의 owner/repository는 lidge-jun 기준입니다. 설치문은 claude plugin install design-isms@lidge-jun이 됩니다.
• AGENTS.md의 디렉토리 구조 절에는 아직 플러그인 파일을 반영하지 않았습니다. 이 PR 방향을 수용하신다면 문서 동기화 규약에 맞춰 함께 갱신하겠습니다.